查询 Royalty 对象列表

返回之前创建过 royalty 对象的一个列表。列表是按创建时间进行排序,总是将最新的 royalty 对象显示在最前。

请求参数描述
payer_app string optional分润发起方对应的 app 对象的 id
recipient_app string optional分润接收方 user 关联的 app 对象的 id
source_app string optional平台的 app 对象的 id
source_no string optional关联订单对象的 merchant_order_no,用于获取指定订单所有的分润和退分润对象。不能和 source_nos 同时使用。
source_nos array optional关联订单对象的 merchant_order_no 列表,用于获取指定订单所有的分润和退分润对象。最多可填写 200 个元素。不能和 source_no 同时使用。
source_user string optional分润接收方 user 对象的 id
status string optional分润状态。值为 created:入账、pending:结算发起、waiting:结算汇总、succeeded:结算成功。
royalty_settlement string optional关联的 royalty_settlement 对象的 id
royalty_transaction string optional关联的 royalty_transaction 对象的 id
page integer optional页码,默认值为 "1",取值范围(1~100000000)。
per_page optional integer每页数量,默认值为 "10"。
created[gt] optional timestamp创建时间大于该值,用 Unix 时间戳表示。
created[gte] optional timestamp创建时间大于或等于该值,用 Unix 时间戳表示。
created[lt] optional timestamp创建时间小于该值,用 Unix 时间戳表示。
created[lte] optional timestamp创建时间小于或等于该值,用 Unix 时间戳表示。

返回

返回一个 royalty 对象,或者返回一个错误,详见 错误

定义

GET https://api.pingxx.com/v1/royalties
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/royalties \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Pingplusplus-Signature: SIGNATURE" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
    "object": "list",
    "url": "/v1/royalties",
    "has_more": false,
    "data": [
        {
            "id": "170301124238000111",
            "object": "royalty",
            "payer_app": "app_1Gqj58ynP0mHeX1q",
            "amount": -1,
            "created": 1488343358,
            "description": "Your description",
            "livemode": true,
            "metadata": {},
            "method": "manual",
            "recipient_app": null,
            "royalty_transaction": null,
            "royalty_settlement": null,
            "source_app": "app_1Gqj58ynP0mHeX1q",
            "source_no": "12345678",
            "source_url": "/v1/orders/2011609010000025991",
            "source_user": "user_001",
            "status": "succeeded",
            "settle_account": null,
            "time_settled": 1488465301
        },
        {...},
        {...}
    ]
}